<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GdaHolder: GNOME Data Access 5 manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="GNOME Data Access 5 manual">
<link rel="up" href="connection.html" title="Connections &amp; commands">
<link rel="prev" href="GdaBatch.html" title="GdaBatch">
<link rel="next" href="GdaSet.html" title="GdaSet">
<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GdaHolder.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GdaHolder.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GdaHolder.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GdaHolder.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
                  <a href="#GdaHolder.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="connection.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GdaBatch.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GdaSet.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GdaHolder"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GdaHolder.top_of_page"></a>GdaHolder</span></h2>
<p>GdaHolder — Container for a single <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a></p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GdaHolder.stability-level"></a><h2>Stability Level</h2>
<a href="http://foldoc.org/Stable"><span class="acronym">Stable</span></a>, unless otherwise indicated
</div>
<div class="refsect1">
<a name="GdaHolder.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-new" title="gda_holder_new ()">gda_holder_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-new-string" title="gda_holder_new_string()">gda_holder_new_string</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-new-boolean" title="gda_holder_new_boolean()">gda_holder_new_boolean</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-new-int" title="gda_holder_new_int()">gda_holder_new_int</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-new-inline" title="gda_holder_new_inline ()">gda_holder_new_inline</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-copy" title="gda_holder_copy ()">gda_holder_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-g-type" title="gda_holder_get_g_type ()">gda_holder_get_g_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-id" title="gda_holder_get_id ()">gda_holder_get_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-value" title="gda_holder_get_value ()">gda_holder_get_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-value-str" title="gda_holder_get_value_str ()">gda_holder_get_value_str</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-value" title="gda_holder_set_value ()">gda_holder_set_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-value-str" title="gda_holder_set_value_str ()">gda_holder_set_value_str</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-take-value" title="gda_holder_take_value ()">gda_holder_take_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-take-static-value" title="gda_holder_take_static_value ()">gda_holder_take_static_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-default-value" title="gda_holder_get_default_value ()">gda_holder_get_default_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-default-value" title="gda_holder_set_default_value ()">gda_holder_set_default_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-value-to-default" title="gda_holder_set_value_to_default ()">gda_holder_set_value_to_default</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-value-is-default" title="gda_holder_value_is_default ()">gda_holder_value_is_default</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-force-invalid" title="gda_holder_force_invalid ()">gda_holder_force_invalid</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-force-invalid-e" title="gda_holder_force_invalid_e ()">gda_holder_force_invalid_e</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-is-valid" title="gda_holder_is_valid ()">gda_holder_is_valid</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-is-valid-e" title="gda_holder_is_valid_e ()">gda_holder_is_valid_e</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-not-null" title="gda_holder_set_not_null ()">gda_holder_set_not_null</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-not-null" title="gda_holder_get_not_null ()">gda_holder_get_not_null</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-source-model" title="gda_holder_set_source_model ()">gda_holder_set_source_model</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="returnvalue">GdaDataModel</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-source-model" title="gda_holder_get_source_model ()">gda_holder_get_source_model</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-bind" title="gda_holder_set_bind ()">gda_holder_set_bind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-bind" title="gda_holder_get_bind ()">gda_holder_get_bind</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-get-attribute" title="gda_holder_get_attribute ()">gda_holder_get_attribute</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-attribute-static" title="gda_holder_set_attribute_static()">gda_holder_set_attribute_static</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GdaHolder.html#gda-holder-set-attribute" title="gda_holder_set_attribute ()">gda_holder_set_attribute</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GdaHolder.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--description" title="The “description” property">description</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--full-bind" title="The “full-bind” property">full-bind</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--g-type" title="The “g-type” property">g-type</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
<tr>
<td class="property_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--id" title="The “id” property">id</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--name" title="The “name” property">name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--not-null" title="The “not-null” property">not-null</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--simple-bind" title="The “simple-bind” property">simple-bind</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--source-column" title="The “source-column” property">source-column</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="type">GdaDataModel</span></a> *</td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--source-model" title="The “source-model” property">source-model</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GdaHolder.html#GdaHolder--validate-changes" title="The “validate-changes” property">validate-changes</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GdaHolder.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdaHolder.html#GdaHolder-attribute-changed" title="The “attribute-changed” signal">attribute-changed</a></td>
<td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdaHolder.html#GdaHolder-changed" title="The “changed” signal">changed</a></td>
<td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdaHolder.html#GdaHolder-source-changed" title="The “source-changed” signal">source-changed</a></td>
<td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></td>
</tr>
<tr>
<td class="signal_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a>*</td>
<td class="signal_name"><a class="link" href="GdaHolder.html#GdaHolder-validate-change" title="The “validate-change” signal">validate-change</a></td>
<td class="signal_flags"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GdaHolder.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody><tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GdaHolder.html#GdaHolder-struct" title="GdaHolder">GdaHolder</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GdaHolder.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
    <span class="lineart">╰──</span> GdaHolder
</pre>
</div>
<div class="refsect1">
<a name="GdaHolder.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GdaHolder implements
 <a class="link" href="GdaLockable.html" title="GdaLockable">GdaLockable</a>.</p>
</div>
<div class="refsect1">
<a name="GdaHolder.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;libgda-report/gda-report-engine.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GdaHolder.description"></a><h2>Description</h2>
<p>The <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> is a container for a single <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> value. It also specifies various attributes
of the contained value (default value, ...)</p>
<p>The type of a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> has to be set and cannot be modified, except if it's initialized
with a GDA_TYPE_NULL GType (representing NULL values) where it can be changed once to a real GType.</p>
<p>Each GdaHolder object is thread safe.</p>
</div>
<div class="refsect1">
<a name="GdaHolder.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gda-holder-new"></a><h3>gda_holder_new ()</h3>
<pre class="programlisting"><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
gda_holder_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>);</pre>
<p>Creates a new holder of type <em class="parameter"><code>type</code></em>
</p>
<div class="refsect3">
<a name="gda-holder-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> requested</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-new-string"></a><h3>gda_holder_new_string()</h3>
<pre class="programlisting">#define             gda_holder_new_string(id,str)</pre>
<p>Creates a new boolean <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object with an ID set to <em class="parameter"><code>id</code></em>
, and a value initialized to 
<em class="parameter"><code>str</code></em>
.</p>
<div class="refsect3">
<a name="gda-holder-new-string.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>str</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-new-string.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-new-boolean"></a><h3>gda_holder_new_boolean()</h3>
<pre class="programlisting">#define             gda_holder_new_boolean(id,abool)</pre>
<p>Creates a new boolean <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object with an ID set to <em class="parameter"><code>id</code></em>
, and a value initialized to 
<em class="parameter"><code>abool</code></em>
.</p>
<div class="refsect3">
<a name="gda-holder-new-boolean.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>abool</p></td>
<td class="parameter_description"><p>a boolean value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-new-boolean.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-new-int"></a><h3>gda_holder_new_int()</h3>
<pre class="programlisting">#define             gda_holder_new_int(id,anint)</pre>
<p>Creates a new boolean <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object with an ID set to <em class="parameter"><code>id</code></em>
, and a value initialized to 
<em class="parameter"><code>anint</code></em>
.</p>
<div class="refsect3">
<a name="gda-holder-new-int.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>anint</p></td>
<td class="parameter_description"><p>an int value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-new-int.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-new-inline"></a><h3>gda_holder_new_inline ()</h3>
<pre class="programlisting"><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
gda_holder_new_inline (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
                       <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
                       <em class="parameter"><code>...</code></em>);</pre>
<p>Creates a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object with an ID set to <em class="parameter"><code>id</code></em>
, of type <em class="parameter"><code>type</code></em>
, 
and containing the value passed as the last argument.</p>
<p>Note that this function is a utility function and that only a limited set of types are supported. Trying
to use an unsupported type will result in a warning, and the returned value holder holding a safe default
value.</p>
<div class="refsect3">
<a name="gda-holder-new-inline.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>a valid GLib type</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>the id of the holder to create, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>value to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-new-inline.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-copy"></a><h3>gda_holder_copy ()</h3>
<pre class="programlisting"><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
gda_holder_copy (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *orig</code></em>);</pre>
<p>Copy constructor.</p>
<p>Note1: if <em class="parameter"><code>orig</code></em>
 is set with a static value (see <a class="link" href="GdaHolder.html#gda-holder-take-static-value" title="gda_holder_take_static_value ()"><code class="function">gda_holder_take_static_value()</code></a>) 
its copy will have a fresh new allocated GValue, so that user should free it when done.</p>
<div class="refsect3">
<a name="gda-holder-copy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>orig</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object to copy</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-copy.returns"></a><h4>Returns</h4>
<p>a new <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-g-type"></a><h3>gda_holder_get_g_type ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
gda_holder_get_g_type (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-id"></a><h3>gda_holder_get_id ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gda_holder_get_id (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get the ID of <em class="parameter"><code>holder</code></em>
. The ID can be set using <em class="parameter"><code>holder</code></em>
's "id" property</p>
<div class="refsect3">
<a name="gda-holder-get-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-id.returns"></a><h4>Returns</h4>
<p> the ID (don't modify the string).</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-value"></a><h3>gda_holder_get_value ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
gda_holder_get_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get the value held into the holder. If <em class="parameter"><code>holder</code></em>
 is set to use its default value
and that default value is not of the same type as <em class="parameter"><code>holder</code></em>
, then <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
<p>If <em class="parameter"><code>holder</code></em>
 is set to NULL, then the returned value is a <a class="link" href="libgda-5.0-Gda-Value.html#GDA-TYPE-NULL:CAPS" title="GDA_TYPE_NULL"><span class="type">GDA_TYPE_NULL</span></a> GValue.</p>
<p>If <em class="parameter"><code>holder</code></em>
 is invalid, then the returned value is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gda-holder-get-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-value.returns"></a><h4>Returns</h4>
<p>the value, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-value-str"></a><h3>gda_holder_get_value_str ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gda_holder_get_value_str (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                          <em class="parameter"><code><a class="link" href="libgda-5.0-Default-Data-handlers.html#GdaDataHandler"><span class="type">GdaDataHandler</span></a> *dh</code></em>);</pre>
<p>Same functionality as <a class="link" href="GdaHolder.html#gda-holder-get-value" title="gda_holder_get_value ()"><code class="function">gda_holder_get_value()</code></a> except that it returns the value as a string
(the conversion is done using <em class="parameter"><code>dh</code></em>
 if not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or the default data handler otherwise).</p>
<div class="refsect3">
<a name="gda-holder-get-value-str.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dh</p></td>
<td class="parameter_description"><p>a <a class="link" href="libgda-5.0-Default-Data-handlers.html#GdaDataHandler"><span class="type">GdaDataHandler</span></a> to use, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-value-str.returns"></a><h4>Returns</h4>
<p>the value, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-value"></a><h3>gda_holder_set_value ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_set_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                      <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
                      <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets the value within the holder. If <em class="parameter"><code>holder</code></em>
 is an alias for another
holder, then the value is also set for that other holder.</p>
<p>On success, the action of any call to <a class="link" href="GdaHolder.html#gda-holder-force-invalid" title="gda_holder_force_invalid ()"><code class="function">gda_holder_force_invalid()</code></a> is cancelled
as soon as this method is called (even if <em class="parameter"><code>holder</code></em>
's value does not actually change)</p>
<p>If the value is not different from the one already contained within <em class="parameter"><code>holder</code></em>
,
then <em class="parameter"><code>holder</code></em>
 is not changed and no signal is emitted.</p>
<p>Note1: the <em class="parameter"><code>value</code></em>
 argument is treated the same way if it is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or if it is a <a class="link" href="libgda-5.0-Gda-Value.html#GDA-TYPE-NULL:CAPS" title="GDA_TYPE_NULL"><span class="type">GDA_TYPE_NULL</span></a> value</p>
<p>Note2: if <em class="parameter"><code>holder</code></em>
 can't accept the <em class="parameter"><code>value</code></em>
 value, then this method returns FALSE, and <em class="parameter"><code>holder</code></em>
 will be left
in an invalid state.</p>
<p>Note3: before the change is accepted by <em class="parameter"><code>holder</code></em>
, the "validate-change" signal will be emitted (the value
of which can prevent the change from happening) which can be connected to to have a greater control
of which values <em class="parameter"><code>holder</code></em>
 can have, or implement some business rules.</p>
<div class="refsect3">
<a name="gda-holder-set-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a value to set the holder to, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-set-value.returns"></a><h4>Returns</h4>
<p> TRUE if value has been set</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-value-str"></a><h3>gda_holder_set_value_str ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_set_value_str (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                          <em class="parameter"><code><a class="link" href="libgda-5.0-Default-Data-handlers.html#GdaDataHandler"><span class="type">GdaDataHandler</span></a> *dh</code></em>,
                          <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>,
                          <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Same functionality as <a class="link" href="GdaHolder.html#gda-holder-set-value" title="gda_holder_set_value ()"><code class="function">gda_holder_set_value()</code></a> except that it uses a string representation
of the value to set, which will be converted into a GValue first (using default data handler if
<em class="parameter"><code>dh</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</p>
<p>Note1: if <em class="parameter"><code>value</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or is the "NULL" string, then <em class="parameter"><code>holder</code></em>
's value is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
Note2: if <em class="parameter"><code>holder</code></em>
 can't accept the <em class="parameter"><code>value</code></em>
 value, then this method returns FALSE, and <em class="parameter"><code>holder</code></em>
 will be left
in an invalid state.</p>
<div class="refsect3">
<a name="gda-holder-set-value-str.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dh</p></td>
<td class="parameter_description"><p>a <a class="link" href="libgda-5.0-Default-Data-handlers.html#GdaDataHandler"><span class="type">GdaDataHandler</span></a> to use, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a value to set the holder to, as a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-set-value-str.returns"></a><h4>Returns</h4>
<p> TRUE if value has been set</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-take-value"></a><h3>gda_holder_take_value ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_take_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                       <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
                       <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets the value within the holder. If <em class="parameter"><code>holder</code></em>
 is an alias for another
holder, then the value is also set for that other holder.</p>
<p>On success, the action of any call to <a class="link" href="GdaHolder.html#gda-holder-force-invalid" title="gda_holder_force_invalid ()"><code class="function">gda_holder_force_invalid()</code></a> is cancelled
as soon as this method is called (even if <em class="parameter"><code>holder</code></em>
's value does not actually change).</p>
<p>If the value is not different from the one already contained within <em class="parameter"><code>holder</code></em>
,
then <em class="parameter"><code>holder</code></em>
 is not changed and no signal is emitted.</p>
<p>Note1: if <em class="parameter"><code>holder</code></em>
 can't accept the <em class="parameter"><code>value</code></em>
 value, then this method returns FALSE, and <em class="parameter"><code>holder</code></em>
 will be left
in an invalid state.</p>
<p>Note2: before the change is accepted by <em class="parameter"><code>holder</code></em>
, the "validate-change" signal will be emitted (the value
of which can prevent the change from happening) which can be connected to to have a greater control
of which values <em class="parameter"><code>holder</code></em>
 can have, or implement some business rules.</p>
<p>Note3: if user previously set this holder with <a class="link" href="GdaHolder.html#gda-holder-take-static-value" title="gda_holder_take_static_value ()"><code class="function">gda_holder_take_static_value()</code></a> the GValue
stored internally will be forgiven and replaced by the <em class="parameter"><code>value</code></em>
. User should then
take care of the 'old' static GValue.</p>
<div class="refsect3">
<a name="gda-holder-take-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a value to set the holder to. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-take-value.returns"></a><h4>Returns</h4>
<p> TRUE if value has been set</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-take-static-value"></a><h3>gda_holder_take_static_value ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
gda_holder_take_static_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                              <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
                              <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value_changed</code></em>,
                              <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets the const value within the holder. If <em class="parameter"><code>holder</code></em>
 is an alias for another
holder, then the value is also set for that other holder.</p>
<p>The value will not be freed, and user should take care of it, either for its
freeing or for its correct value at the moment of query.</p>
<p>If the value is not different from the one already contained within <em class="parameter"><code>holder</code></em>
,
then <em class="parameter"><code>holder</code></em>
 is not changed and no signal is emitted.</p>
<p>Note1: if <em class="parameter"><code>holder</code></em>
 can't accept the <em class="parameter"><code>value</code></em>
 value, then this method returns NULL, and <em class="parameter"><code>holder</code></em>
 will be left
in an invalid state.</p>
<p>Note2: before the change is accepted by <em class="parameter"><code>holder</code></em>
, the "validate-change" signal will be emitted (the value
of which can prevent the change from happening) which can be connected to to have a greater control
of which values <em class="parameter"><code>holder</code></em>
 can have, or implement some business rules.</p>
<div class="refsect3">
<a name="gda-holder-take-static-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a const value to set the holder to</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value_changed</p></td>
<td class="parameter_description"><p>a boolean set with TRUE if the value changes, FALSE elsewhere.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-take-static-value.returns"></a><h4>Returns</h4>
<p> NULL if an error occurred or if the previous GValue was NULL itself. It returns
the static GValue user set previously, so that he can free it.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-default-value"></a><h3>gda_holder_get_default_value ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
gda_holder_get_default_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get the default value held into the holder. WARNING: the default value does not need to be of 
the same type as the one required by <em class="parameter"><code>holder</code></em>
.</p>
<div class="refsect3">
<a name="gda-holder-get-default-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-default-value.returns"></a><h4>Returns</h4>
<p> the default value</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-default-value"></a><h3>gda_holder_set_default_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gda_holder_set_default_value (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                              <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>Sets the default value within the holder. If <em class="parameter"><code>value</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <em class="parameter"><code>holder</code></em>
 won't have a
default value anymore. To set a default value to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then pass a <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> created using
<a class="link" href="libgda-5.0-Gda-Value.html#gda-value-new-null" title="gda_value_new_null ()"><code class="function">gda_value_new_null()</code></a>.</p>
<p>NOTE: the default value does not need to be of the same type as the one required by <em class="parameter"><code>holder</code></em>
.</p>
<div class="refsect3">
<a name="gda-holder-set-default-value.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a value to set the holder's default value, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-value-to-default"></a><h3>gda_holder_set_value_to_default ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_set_value_to_default (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Set <em class="parameter"><code>holder</code></em>
's value to its default value.</p>
<div class="refsect3">
<a name="gda-holder-set-value-to-default.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-set-value-to-default.returns"></a><h4>Returns</h4>
<p> TRUE if <em class="parameter"><code>holder</code></em>
has got a default value</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-value-is-default"></a><h3>gda_holder_value_is_default ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_value_is_default (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Tells if <em class="parameter"><code>holder</code></em>
's current value is the default one.</p>
<div class="refsect3">
<a name="gda-holder-value-is-default.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-value-is-default.returns"></a><h4>Returns</h4>
<p> TRUE if <em class="parameter"><code>holder</code></em>
<em class="parameter"><code>holder</code></em>
's current value is the default one</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-force-invalid"></a><h3>gda_holder_force_invalid ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gda_holder_force_invalid (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Forces a holder to be invalid; to set it valid again, a new value must be assigned
to it using <a class="link" href="GdaHolder.html#gda-holder-set-value" title="gda_holder_set_value ()"><code class="function">gda_holder_set_value()</code></a> or <a class="link" href="GdaHolder.html#gda-holder-take-value" title="gda_holder_take_value ()"><code class="function">gda_holder_take_value()</code></a>.</p>
<p><em class="parameter"><code>holder</code></em>
's value is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gda-holder-force-invalid.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-force-invalid-e"></a><h3>gda_holder_force_invalid_e ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gda_holder_force_invalid_e (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                            <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>);</pre>
<p>Forces a holder to be invalid; to set it valid again, a new value must be assigned
to it using <a class="link" href="GdaHolder.html#gda-holder-set-value" title="gda_holder_set_value ()"><code class="function">gda_holder_set_value()</code></a> or <a class="link" href="GdaHolder.html#gda-holder-take-value" title="gda_holder_take_value ()"><code class="function">gda_holder_take_value()</code></a>.</p>
<p><em class="parameter"><code>holder</code></em>
's value is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gda-holder-force-invalid-e.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> explaining why <em class="parameter"><code>holder</code></em>
is declared invalid, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 4.2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-is-valid"></a><h3>gda_holder_is_valid ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_is_valid (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get the validity of <em class="parameter"><code>holder</code></em>
 (that is, of the value held by <em class="parameter"><code>holder</code></em>
)</p>
<div class="refsect3">
<a name="gda-holder-is-valid.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-is-valid.returns"></a><h4>Returns</h4>
<p> TRUE if <em class="parameter"><code>holder</code></em>
's value can safely be used</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-is-valid-e"></a><h3>gda_holder_is_valid_e ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_is_valid_e (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                       <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Get the validity of <em class="parameter"><code>holder</code></em>
 (that is, of the value held by <em class="parameter"><code>holder</code></em>
)</p>
<div class="refsect3">
<a name="gda-holder-is-valid-e.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store invalid error, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-is-valid-e.returns"></a><h4>Returns</h4>
<p> TRUE if <em class="parameter"><code>holder</code></em>
's value can safely be used</p>
</div>
<p class="since">Since: 4.2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-not-null"></a><h3>gda_holder_set_not_null ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gda_holder_set_not_null (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> not_null</code></em>);</pre>
<p>Sets if the holder can have a NULL value. If <em class="parameter"><code>not_null</code></em>
 is TRUE, then that won't be allowed</p>
<div class="refsect3">
<a name="gda-holder-set-not-null.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>not_null</p></td>
<td class="parameter_description"><p>TRUE if <em class="parameter"><code>holder</code></em>
should not accept <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> values</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-not-null"></a><h3>gda_holder_get_not_null ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_get_not_null (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get wether the holder can be NULL or not</p>
<div class="refsect3">
<a name="gda-holder-get-not-null.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-not-null.returns"></a><h4>Returns</h4>
<p> TRUE if the holder cannot be NULL</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-source-model"></a><h3>gda_holder_set_source_model ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_set_source_model (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                             <em class="parameter"><code><a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="type">GdaDataModel</span></a> *model</code></em>,
                             <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> col</code></em>,
                             <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets an hint that <em class="parameter"><code>holder</code></em>
's values should be restricted among the values
contained in the <em class="parameter"><code>col</code></em>
 column of the <em class="parameter"><code>model</code></em>
 data model. Note that this is just a hint,
meaning this policy is not enforced by <em class="parameter"><code>holder</code></em>
's implementation.</p>
<p>If <em class="parameter"><code>model</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the effect is to cancel ant previous call to <a class="link" href="GdaHolder.html#gda-holder-set-source-model" title="gda_holder_set_source_model ()"><code class="function">gda_holder_set_source_model()</code></a>
where <em class="parameter"><code>model</code></em>
 was not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gda-holder-set-source-model.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="type">GdaDataModel</span></a> object or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>col</p></td>
<td class="parameter_description"><p>the reference column in <em class="parameter"><code>model</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>location to store error, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-set-source-model.returns"></a><h4>Returns</h4>
<p> TRUE if no error occurred</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-source-model"></a><h3>gda_holder_get_source_model ()</h3>
<pre class="programlisting"><a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="returnvalue">GdaDataModel</span></a> *
gda_holder_get_source_model (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                             <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *col</code></em>);</pre>
<p>If <a class="link" href="GdaHolder.html#gda-holder-set-source-model" title="gda_holder_set_source_model ()"><code class="function">gda_holder_set_source_model()</code></a> has been used to provide a hint that <em class="parameter"><code>holder</code></em>
's value
should be among the values contained in a column of a data model, then this method
returns which data model, and if <em class="parameter"><code>col</code></em>
 is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it is set to the restricting column
as well.</p>
<p>Otherwise, this method returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, and if <em class="parameter"><code>col</code></em>
 is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it is set to 0.</p>
<div class="refsect3">
<a name="gda-holder-get-source-model.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>col</p></td>
<td class="parameter_description"><p>a place to store the column in the model sourcing the holder, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-source-model.returns"></a><h4>Returns</h4>
<p>a pointer to a <a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="type">GdaDataModel</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-bind"></a><h3>gda_holder_set_bind ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gda_holder_set_bind (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                     <em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *bind_to</code></em>,
                     <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets <em class="parameter"><code>holder</code></em>
 to change when <em class="parameter"><code>bind_to</code></em>
 changes (and does not make <em class="parameter"><code>bind_to</code></em>
 change when <em class="parameter"><code>holder</code></em>
 changes).
For the operation to succeed, the GType of <em class="parameter"><code>holder</code></em>
 and <em class="parameter"><code>bind_to</code></em>
 must be the same, with the exception that
any of them can have a <a class="link" href="libgda-5.0-Gda-Value.html#GDA-TYPE-NULL:CAPS" title="GDA_TYPE_NULL"><code class="literal">GDA_TYPE_NULL</code></a> type (in this situation, the GType of the two <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> objects
involved is set to match the other when any of them sets its type to something different than GDA_TYPE_NULL).</p>
<p>If <em class="parameter"><code>bind_to</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then <em class="parameter"><code>holder</code></em>
 will not be bound anymore.</p>
<div class="refsect3">
<a name="gda-holder-set-bind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>bind_to</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a place to store errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-set-bind.returns"></a><h4>Returns</h4>
<p> TRUE if no error occurred</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-bind"></a><h3>gda_holder_get_bind ()</h3>
<pre class="programlisting"><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="returnvalue">GdaHolder</span></a> *
gda_holder_get_bind (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>);</pre>
<p>Get the holder which makes <em class="parameter"><code>holder</code></em>
 change its value when the holder's value is changed.</p>
<div class="refsect3">
<a name="gda-holder-get-bind.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-bind.returns"></a><h4>Returns</h4>
<p>the <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-get-attribute"></a><h3>gda_holder_get_attribute ()</h3>
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="returnvalue">GValue</span></a> *
gda_holder_get_attribute (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                          <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>);</pre>
<p>Get the value associated to a named attribute.</p>
<p>Attributes can have any name, but Libgda proposes some default names, see this section.</p>
<div class="refsect3">
<a name="gda-holder-get-attribute.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attribute</p></td>
<td class="parameter_description"><p>attribute name as a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gda-holder-get-attribute.returns"></a><h4>Returns</h4>
<p> a read-only <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not attribute named <em class="parameter"><code>attribute</code></em>
has been set for <em class="parameter"><code>holder</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-attribute-static"></a><h3>gda_holder_set_attribute_static()</h3>
<pre class="programlisting">#define             gda_holder_set_attribute_static(holder,attribute,value)</pre>
<p>This function is similar to <a class="link" href="GdaHolder.html#gda-holder-set-attribute" title="gda_holder_set_attribute ()"><code class="function">gda_holder_set_attribute()</code></a> but for static strings</p>
<div class="refsect3">
<a name="gda-holder-set-attribute-static.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attribute</p></td>
<td class="parameter_description"><p>attribute's name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gda-holder-set-attribute"></a><h3>gda_holder_set_attribute ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gda_holder_set_attribute (<em class="parameter"><code><a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder</code></em>,
                          <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *attribute</code></em>,
                          <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>,
                          <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
<p>Set the value associated to a named attribute. The <em class="parameter"><code>attribute</code></em>
 string is 'stolen' by this method, and
the memory it uses will be freed using the <em class="parameter"><code>destroy</code></em>
 function when no longer needed (if <em class="parameter"><code>destroy</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
then the string will not be freed at all).</p>
<p>Attributes can have any name, but Libgda proposes some default names, 
see this section.</p>
<p>For example one would use it as:</p>
<code class="code">gda_holder_set_attribute (holder, g_strdup (my_attribute), my_value, g_free);</code><code class="code">gda_holder_set_attribute (holder, GDA_ATTRIBUTE_NAME, my_value, NULL);</code><p>If there is already an attribute named <em class="parameter"><code>attribute</code></em>
 set, then its value is replaced with the new value (<em class="parameter"><code>value</code></em>
 is
copied), except if <em class="parameter"><code>value</code></em>
 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case the attribute is removed.</p>
<div class="refsect3">
<a name="gda-holder-set-attribute.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>a <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attribute</p></td>
<td class="parameter_description"><p>attribute name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>destroy</p></td>
<td class="parameter_description"><p>a function to be called when <em class="parameter"><code>attribute</code></em>
is not needed anymore, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GdaHolder.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GdaHolder-struct"></a><h3>GdaHolder</h3>
<pre class="programlisting">typedef struct _GdaHolder GdaHolder;</pre>
</div>
</div>
<div class="refsect1">
<a name="GdaHolder.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GdaHolder--description"></a><h3>The <code class="literal">“description”</code> property</h3>
<pre class="programlisting">  “description”              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Holder's description.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--full-bind"></a><h3>The <code class="literal">“full-bind”</code> property</h3>
<pre class="programlisting">  “full-bind”                <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *</pre>
<p>Make value holder follow other GdaHolder's changes and the other way around.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--g-type"></a><h3>The <code class="literal">“g-type”</code> property</h3>
<pre class="programlisting">  “g-type”                   <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> *</pre>
<p>Holder's GType.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write / Construct</p>
<p>Allowed values: void</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--id"></a><h3>The <code class="literal">“id”</code> property</h3>
<pre class="programlisting">  “id”                       <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Holder's ID.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--name"></a><h3>The <code class="literal">“name”</code> property</h3>
<pre class="programlisting">  “name”                     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Holder's name.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--not-null"></a><h3>The <code class="literal">“not-null”</code> property</h3>
<pre class="programlisting">  “not-null”                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Can the value holder be NULL?.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--simple-bind"></a><h3>The <code class="literal">“simple-bind”</code> property</h3>
<pre class="programlisting">  “simple-bind”              <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *</pre>
<p>Make value holder follow other GdaHolder's changes.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--source-column"></a><h3>The <code class="literal">“source-column”</code> property</h3>
<pre class="programlisting">  “source-column”            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<p>Column number to use in coordination with the source-model property.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--source-model"></a><h3>The <code class="literal">“source-model”</code> property</h3>
<pre class="programlisting">  “source-model”             <a class="link" href="GdaDataModel.html" title="GdaDataModel"><span class="type">GdaDataModel</span></a> *</pre>
<p>Data model among which the holder's value should be.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder--validate-changes"></a><h3>The <code class="literal">“validate-changes”</code> property</h3>
<pre class="programlisting">  “validate-changes”         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Defines if the "validate-change" signal gets emitted when
the holder's value changes.</p>
<p>Owner: GdaHolder</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 5.2.0</p>
</div>
</div>
<div class="refsect1">
<a name="GdaHolder.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GdaHolder-attribute-changed"></a><h3>The <code class="literal">“attribute-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder,
               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>     *att_name,
               <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a>    *att_value,
               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)</pre>
<p>Gets emitted when any <em class="parameter"><code>holder</code></em>
's attribute has changed</p>
<div class="refsect3">
<a name="GdaHolder-attribute-changed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>the <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>att_name</p></td>
<td class="parameter_description"><p>attribute's name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>att_value</p></td>
<td class="parameter_description"><p>attribute's value</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder-changed"></a><h3>The <code class="literal">“changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder,
               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)</pre>
<p>Gets emitted when <em class="parameter"><code>holder</code></em>
's value has changed</p>
<div class="refsect3">
<a name="GdaHolder-changed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>the <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder-source-changed"></a><h3>The <code class="literal">“source-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder,
               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)</pre>
<p>Gets emitted when the data model in which <em class="parameter"><code>holder</code></em>
's values should be has changed</p>
<div class="refsect3">
<a name="GdaHolder-source-changed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>the <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS">Run First</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GdaHolder-validate-change"></a><h3>The <code class="literal">“validate-change”</code> signal</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a>*
user_function (<a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> *holder,
               <a href="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a>    *new_value,
               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)</pre>
<p>Gets emitted when <em class="parameter"><code>holder</code></em>
 is going to change its value. One can connect to
this signal to control which values <em class="parameter"><code>holder</code></em>
 can have (for example to implement some business rules)</p>
<div class="refsect3">
<a name="GdaHolder-validate-change.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>holder</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>new_value</p></td>
<td class="parameter_description"><p>the proposed new value for <em class="parameter"><code>holder</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="GdaHolder-validate-change.returns"></a><h4>Returns</h4>
<p> NULL if <em class="parameter"><code>holder</code></em>
is allowed to change its value to <em class="parameter"><code>new_value</code></em>
, or a <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>
otherwise.</p>
</div>
<p>Flags: <a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
</div>
</div>
<div class="refsect1">
<a name="GdaHolder.see-also"></a><h2>See Also</h2>
<p>The <a class="link" href="GdaSet.html" title="GdaSet"><span class="type">GdaSet</span></a> object which "groups" several <a class="link" href="GdaHolder.html" title="GdaHolder"><span class="type">GdaHolder</span></a> objects</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.32</div>
</body>
</html>